全部文档

设备ota

（可选）设备连接OTA服务，上报版本号。设备端通过MQTT协议推送当前设备OTA模块版本号到Topic：直连设备: $sys/{pid}/{did}/ota/device/inform; 网关子设备: $sys/{gpid}/{gdid}/{pid}/{did}/ota/device/inform。消息格式如下：请求数据:

{
  "params": {
    "pid":"100040",
    "did":"10000064",
    "fVersion":"2.0", 
    "sVersion":"2.0", 
    "manuf":"001",
    "model":"00108"
  }
}

表 . 参数说明

参数	类型	说明
did	String	设备id
pid	String	产品id
fVersion	String	模组版本号
sVersion	String	应用服务版本号
manuf	String	厂商名称
model	String	模组型号

您在控制台触发升级操作之后，设备会收到物联网平台OTA服务推送的升级包的URL地址。设备端订阅Topic：直连设备: $sys/{pid}/{did}/ota/device/upgrade; 网关子设备:$sys/{gpid}/{gdid}/{pid}/{did}/ota/device/upgrade。控制台对设备发起OTA升级请求后，设备端会通过该Topic收到升级包的存储地址URL。

消息格式如下：

{
  "code": 200,
  "data":{
      "target":"1.2", 

      "token":"ota_5hc95SFeo5xJEnaNrste",

      "size":123,

      "signal":12,

      "power":90,

      "retry":10,

      "interval":90,

      "md5":"dfkdajkfd",

      "url":"172.19.3.3:8002/ota/download/ota_5hc95SFeo5xJEnaNrste"
  }   
}

表 . 参数说明

参数	类型	说明
code	Int	状态码。
data	Object	升级信息
target	String	升级任务的目标版本
token	String	后续操作的鉴权信息
size	Long	文件大小
signal	int	任务在大于该信号下进行
power	int	任务在大于该电量下进行
retry	int	重试次数
interval	int	重试间隔(秒)
md5	string	升级文件的md5
url	string	文件下载地址

设备收到URL之后，通过HTTP协议根据URL下载升级包。
升级过程中，设备端向服务端推送升级进度到Topic：直连设备: $sys/{pid}/{did}/ota/device/progress; 网关子设备: $sys/{gpid}/{gdid}/{pid}/{did}ota/device/progress。消息格式如下：

{
  "params": {
    "pid":"123",
    "did":"123",
    "step":11, 
    "token":"ota_5hc95SFeo5xJEnaNrste"
  }
}

表 . 参数说明

参数	类型	说明
step	String	OTA升级进度信息。取值范围：1~100的整数
token	String	鉴权信息
did	String	设备id
pid	String	产品id

设备端完成OTA升级后，推送升级状态到Topic：直连设备: $sys/{pid}/{did}/ota/device/status; 网关子设备: $sys/{gpid}/{gdid}/{pid}/{did}/ota/device/status。

{
  "params": {
    "pid":"123",
    "did":"123",
    "result":101,
    "token":"ota_5hc95SFeo5xJEnaNrste"
}

表 . 参数说明

参数	类型	说明
id	string	消息id号，用户自定义，String类型的数字，长度限制不超过13位。可选
result	int	升级状态码 101:升级包下载成功；102:下载失败,空间不足；103:下载失败,内存溢出；104:下载失败,下载请求超时； 105:下载失败,电量不足； 106:下载失败,信号不良； 107:下载失败,未知异常； 201:升级成功； 202:升级失败,电量不足； 203:升级失败,内存溢出； 204:升级失败,版本不一致； 205:升级失败,MD5校验失败； 206:升级失败,未知异常 207:升级失败，达到最大重试次数
token	String	鉴权信息
did	String	设备id
pid	String	产品id

设备ota

results matching ""

No results matching ""